home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / amiga / viewers / superviw / supervie.doc < prev    next >
Text File  |  1991-08-07  |  13KB  |  392 lines
  1.  
  2.     SuperView,   A IFF display program.  by  David  Grothe  V 3.1.1
  3.     Release Date   08-08-91
  4.  
  5.     *
  6.     * Copyright 1989, 1990, 1991 by David Grothe
  7.     * All rights reserved.
  8.     *
  9.     * This program is Shareware,  if you use this program
  10.     * you must send $10 to: 
  11.     *
  12.     * David Grothe
  13.     * 13000 Springcreek CT
  14.     * Okla City, OK  73170
  15.     *
  16.     * If you have sent in the shareware on version 2x, or 3.0, then you 
  17.     * need not send in shareware for this version..  And thank you!
  18.     *
  19.     * You may pass the program around as long as this Doc file 
  20.     * remains a part of it.
  21.     *
  22.     * If you would like to distribute this program with your 
  23.     * software, you must contact me first.
  24.     * 
  25.     * This product is now supported by The Byte Factory!
  26.  
  27.  
  28. SuperView is a program that will display IFF pictures of all types 
  29. on the Amiga.  The program supports the following features:
  30.  
  31.     Multiple files on one command line.
  32.     WorkBench  (icons) are supported.
  33.     All display modes supported.
  34.     Auto Overscan
  35.     Color Cycle ( DPaint and GraphiCraft types)  CRNG  CCRT
  36.     AmigaBasic  ACBM  type files
  37.     Author chunk is supported
  38.     Displays the first cell in a ANIM file
  39.     Written in Assembly, PURE code that can be resident under 1.3 an up.
  40.     Display Animations.  (Type 5 - DPaintIII, VideoScape2.0)
  41.  
  42. * NEW * for 3.1
  43.  
  44. Version 3.1 is a complete rewrite of some of the loading code that SuperView
  45. used.  The reason for this was to make it a little more flexible with the new
  46. ANIM types that are coming out.  Many bugs have popped up with version 3.0,
  47. most dealing with the Animations and others with the new Workbench 2.0.
  48. I think I have got most all of the bugs out before the release this time..
  49.  
  50. Here is a list of all of the new things for 3.1:
  51.  
  52.   More controls have been added to help you control SuperView after the 
  53.   picture is loaded.  These include:
  54.  
  55.     P     Turns the pointer on or off.
  56.     I    Displays Information screen.
  57.     A    Displays Author test.  (Also ANNO Text)
  58.     F1    Speed up Animation
  59.     F2    Slow down Animation
  60.  
  61.     Up, Down, Left, Right Arrows move the overscan offset around.
  62.  
  63.   Displays SHAM and SLOP pictures.
  64.  
  65.   Supports the ANNO chunk the same as the AUTH chunk.
  66.  
  67.   Supports a color map change for each frame of an animation.
  68.  
  69.   Allows you to enter options in the pictures file note.  These options 
  70.   will be used when displaying the picture.  For example, if you want a
  71.   certain picture not to color cycle,  put a -c in the file note.  When 
  72.   SuperView finds the option, it won't cycle the picture.  This can also
  73.   be used to position certain pictures on the screen the way you like,
  74.  
  75.   The -d option is no longer used.  SuperView will automatically see that
  76.   you are trying to show a directory.   ie   SuperView PIC:
  77.  
  78.  
  79.  
  80. Display options include the following:
  81.  
  82.     -c         Suppress Color Cycling
  83.     -f <file>    Read a text file for picture names
  84.     -h<n>       Change the display height of a picture
  85.     -j<n>        Force <n> Jiffies between frames
  86.     -m<x>       Select view modes.
  87.     -n        No ANIM, show picture only
  88.     -o           Override the Auto Overscan 
  89.     -p           Disables Pointer Clearing
  90.     -r           Repeat command line
  91.     -s<n>        Display picture for n seconds
  92.     -v        Stop Animation after one time through.
  93.     -w<n>        Change the display width
  94.     -x<n>        Change the position of the display area x
  95.     -y<n>        Change the position of the display area y
  96.  
  97.  
  98. Controls:
  99.  
  100.     Left Mouse Button     Scrolls around in a picture
  101.     Right Mouse Button     Continues to next picture
  102.     TAB             Starts and stops the color cycling
  103.     ESC             Aborts the command line
  104.     SpaceBar        Starts and stops animations
  105.     Return            Step through animation
  106.  
  107. * NEW  CONTROLS *
  108.  
  109.     P     Turns the pointer on or off.
  110.     I    Displays Information screen.
  111.     A    Displays Author test.  (Also ANNO Text)
  112.     F1    Speed up Animation
  113.     F2    Slow down Animation
  114.  
  115.     Up, Down, Left, Right Arrows move the overscan offset around.
  116.  
  117.  
  118. Using SuperView from WorkBench.
  119.  
  120. SuperView has a complete WorkBench (Icon) interface built in.  
  121. To use SuperView from WorkBench, you must have an icon for your picture. 
  122. Most all paint programs build icons for you as you save a picture, so 
  123. this should not be a problem.  There are two ways to view pictures at 
  124. this point.  The easy way is to click once on the picture icon, hold 
  125. down the shift key, and then double click the SuperView icon.  You can 
  126. reverse this and click once on the SuperView icon and double click your 
  127. picture icon.  To view more that one picture,  you hold down the shift 
  128. key and click each picture that you want to show and the SuperView icon.  
  129. You don't have to select the icons in any kind of order as long as you 
  130. double click the last icon you select.  The pictures will be displayed 
  131. in the order that you select them.  You can also make the picture icon 
  132. itself run SuperView by putting SuperView in the default tool of the 
  133. icon.  This way you can just double click the picture icon to view it.  
  134. For a detailed description of how this is done, see the article in 
  135. Ami Exchange Mag V1.4.  
  136.  
  137. After the picture is loaded from workbench, you can stop and start the 
  138. color cycling with the TAB key, hold down the left mouse button to 
  139. scroll around in a large bitmap picture, press the right mouse button 
  140. to go to the next picture,  or press the ESC key to abort. Pressing the 
  141. ESC key will remove the current picture and cancel out any pictures that 
  142. you had selected that you have not viewed yet.
  143.  
  144.  
  145. Using SuperView from the CLI
  146.  
  147. Here is where the real power of SuperView comes out.  
  148. From the CLI,  you can choose many display options that allow you to 
  149. view a picture in different ways.  The command line from the CLI is
  150.  
  151. 1> SuperView [option[...]] <fileName> [[option[...]] <fileName>].... 
  152.  
  153. You can use up to 255 characters on the command line.  
  154. Here is a list of the options and how to use them.
  155.  
  156.  
  157.     -c    Suppress Color Cycling
  158.  
  159. This option will prevent the picture from color cycling.  If you use this 
  160. option,  the spacebar will not start color cycling.  
  161.  
  162. Example:
  163.  
  164. 1> SuperView -c <Picture>
  165.  
  166.  
  167.     -f <file>    Read a text file for picture names
  168.  
  169. This option will read a text file and use it as a script to display 
  170. pictures.  The format of the file is the same as the format of each 
  171. picture on the command line.  
  172.  
  173. Example:
  174.  
  175. -s10 MyPicture
  176. -s10 -c df0:
  177. GreatPic
  178. -x200 -y100 BigPic
  179.  
  180. Each picture in the file can have its own options.  When all of the files 
  181. have been displayed,  SuperView will continue with the rest of the 
  182. command line.
  183.  
  184. Example:
  185.  
  186. 1> SuperView -f MyScript
  187. 1> SuperView -f MyScript -r
  188. 1> SuperView -f MyScript -s10 <Picture>
  189.  
  190.  
  191.     -h<n>   Change the display height of a picture
  192.     -w<n>    Change the display width
  193.  
  194. These two options change the display size of a picture.  You can use one 
  195. or both of them on a picture.  These options change the display size of 
  196. the picture, not the size of the picture.   If you tell it to use a 
  197. smaller display size than the picture is, you will be able to scroll 
  198. around in the smaller display area.  The best way to under stand this may 
  199. be to try it.   
  200.  
  201. Example:
  202.  
  203. 1> SuperView -w320 -h200 <Picture>
  204. 1> SuperView -w320 -h200 -m <Picture>
  205. 1> SuperView -w200 -h100 -x60 -y50 <Picture>
  206.  
  207.  
  208.     -j<n>   Force <n> Number of Jiffies between frames
  209.  
  210. When displaying an animation, this will allow you to change the 
  211. playback speed.  A Jiffy is 1/60th of a second, so the greater the
  212. number, the slower the animation is.
  213.  
  214. Example:
  215.  
  216. 1> SuperView -j6 Cry
  217.  
  218.  
  219.     -m<x>   Select view modes  
  220.     h = HAM 
  221.     r = HiRes 
  222.     l =Lace
  223.     b = HalfBrite
  224.  
  225. This will allow you to change any display modes that you want.  The 
  226. display modes that are supported are,  Hi-Res (640 display), 
  227. Lace (interlace), HAM (Hold And Modify), and Extra-HalfBrite.  If you 
  228. just select -m option without any letters following it, all modes will be 
  229. cleared.  If the modes are clear, you will get a standard lo-res screen.  
  230. This is good for taking a Hi-Res, Lace picture and making it Lo-Res.
  231.  
  232. Example:
  233.  
  234. 1> SuperView -w320 -h200 -m <Picture>
  235. 1> SuperView -w320 -h200 -ml <Picture>
  236.  
  237. This will give you a 320 X 200 picture of <Picture> that you can scroll 
  238. around in.  
  239.  
  240.     -n   No Animation.
  241.  
  242. Use this flag to prevent SuperView from playing an animation.  SuperView
  243. will go ahead and load the first frame and treat it as a normal picture.
  244.  
  245.  
  246.     -o   Override the Auto Overscan 
  247.  
  248. This will cause SuperView to display the picture exactly like the IFF 
  249. file said to.  No attempt to size or place the picture is made.
  250.  
  251. Example:
  252.  
  253. 1> SuperView -o <Picture>
  254.  
  255.  
  256.     -p   Disables Pointer Clearing
  257.  
  258. If you don't want your pointer to disappear when showing the picture,  
  259. then use this option.
  260.  
  261. Example:
  262.  
  263. 1> SuperView -p <Picture>
  264.  
  265.  
  266.     -r   Repeat command line
  267.  
  268. This will cause SuperView to repeat the command line in a loop.  With 
  269. this option, the -s and -d or -f options, you can make a slide show.  
  270. This is the only option that you put after everything else and everything 
  271. past the -r is ignored.  The only way to stop this is to hit the ESC key.
  272.  
  273. Example:
  274.  
  275. 1> SuperView <Picture> <Picture> -r
  276. 1> SuperView -s10 <Picture> -s5 <Picture> -r
  277.  
  278.  
  279.     -s<n>  Display picture for n seconds
  280.  
  281. This option will remove the picture after n seconds.  You can still 
  282. continue by pressing the right mouse button or ESC key. 
  283.  
  284. Example:
  285.  
  286. 1> SuperView -s10 <Picture>
  287. 1> SuperView -s10 df1:
  288.  
  289.  
  290. -vPlay once only.
  291.  
  292. This option will cause SuperView to play through an Animation only
  293. one time.  Some Animations do not loop and need this flag to display
  294. correctly.
  295.  
  296.  
  297.     -x<n>    Change the position of the display area x
  298.     -y<n>    Change the position of the display area y
  299.  
  300. The -x and -y options are used to position the display area on the screen. 
  301. For overscan, you need to shift the picture to the left and up from the 
  302. normal 0x 0y so you use  -x-16 to shift left and -y-8 to shift up. Also, 
  303. if you want to change the display size with the -w and -h options, you 
  304. can center the smaller screen with these options.
  305.  
  306. Example:
  307.  
  308. 1> SuperView -x20 -y10 <Picture>
  309. 1> SuperView -w200 -h100 -x60 -y50 <Picture>
  310.  
  311.  
  312.  
  313. About the animation.  SuperView will now display type 5 animations.
  314. Type 5 animations are the ones use by DPaintIII and VideoScape2.0
  315. All of the other options will still function with the animation.  
  316. To stop an animation, press the spacebar.
  317. After the animation is stopped, you can step through it using the return
  318. key.  ColorCycling remains in active during the animation unless you 
  319. press the TAB key or use the -c option.  Due to the size of animation
  320. files, when you move from an animation to the next picture/animation
  321. the animation will stop while the next is loaded.  Before loading the 
  322. next picture/animation, SuperView will free all of the animation data,
  323. free the second bitmap (double-buffer), and leave the last frame still
  324. showing like a normal picture while loading the next.
  325.  
  326.  
  327. Fixed in 3.0
  328. Overscan now works correctly.
  329.  
  330. You can now start the color cycling even it you use the -c option.
  331.  
  332. The delay function now waits for the correct time between two pictures
  333. even if you press the right mouse button.
  334.  
  335.  
  336. If you have any problems with the program, you can leave me a message
  337. on Amy Source BBS at (405) 793-1097....
  338.  
  339.  
  340.  
  341.  
  342.  
  343. On more thing for 3.1.  It now return error codes for different reasons.
  344. The following is a list of the error codes returned.
  345.  
  346.  
  347. 20    Picture is a RGB file.
  348. 21    Memory allocation failure for AUTH chunk
  349. 22    Memory Allocation failure for Color cycling chunk
  350. 23    Memory Allocation failure for Color map
  351. 24    Unknown compression type
  352. 25    Unable to allocate main structure
  353. 26    Unable to open the file
  354. 27    Read error
  355. 28    Memory allocation for Misc chunks error.
  356. 29    Unknown file type.   (Not IFF)
  357. 30    Could not allocate a bitmap.
  358. 31    Could not open the timer device
  359. 32    Memory allocation failure for CCRT chunk.
  360. 33    Dynamic Ham or Hi-res picture
  361. 34    Memory allocation failure for Main Animation structure
  362. 35    Memory allocation failure for an Animation frame node.
  363. 36    Invalid ANIM format
  364. 37    Two DLTA chunks in one FORM ILBM section.
  365. 38    Misc Memory allocation error.
  366. 39    Could not lock the file
  367.  
  368.  
  369. There is a program called GetError and a script file that I have supplied
  370. that will allow SuperView to dump off Dynamic Pictures to Dyna-Show
  371. If you are using Workbench 2.0 then you won't need the GetError and there
  372. is another script for 2.0.
  373.  
  374.  
  375.  
  376. **  3.1.1 Update!  
  377.  
  378.  This release is mostly some bug fixes and only one new feature that may
  379. be consitdered a bug..  
  380.  
  381.  First, over size pictures work much better.  There was a bug that allowed
  382. the Hi-Res and HAM bits both get set for certain picture sizes.  This fixes
  383. the oversized DCTV pictures also.
  384.  
  385.  Next, fixed a small timing bug in animations that have color changes for
  386. each frame.  Before,  these pictures would flash between frames.
  387.  
  388.  And finally, added support for a ILBM with a mask such as a picture from
  389. DPaint saved with the stencil on.
  390.  
  391.  
  392.